home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc A) / Acorn User China CD-ROM (UK) (Disc A).bin / DEMON / DEVELOPER / MPEGTOOL.ARC / !MPEGplay_!Help < prev    next >
Encoding:
Text File  |  1995-04-13  |  4.2 KB  |  130 lines
  1.                       MPEG Video Software Decoder
  2.                        (Version 2.1; Feb 1 1995)
  3.                   
  4.   Lawrence A. Rowe, Ketan Patel, Brian Smith, Steve Smoot, and Eugene Hung
  5.       Computer Science Division-EECS, Univ. of Calif. at Berkeley
  6.  
  7.                    RISC OS version 1.0 (Apr 13 1995)
  8.  
  9. Description
  10. -----------
  11.  
  12. This is a port of the MPEG Video Software Decoder, as released by the
  13. University of California at Berkeley. The decoder can be used in two
  14. ways:
  15.  
  16. 1. After the !MPEGplay directory has been seen by the filer, double
  17.    clicking on a MPEG file (filetype &BF8, or simply MPEG) will
  18.    start playback.
  19.  
  20. 2. By means of the !MPEGplay application. After this application has been
  21.    started, all playback is handled through this program. The main task
  22.    of !MPEGplay is to provide a quick way of setting the command line
  23.    options of the decoder. As an extra option, it offers the possibility
  24.    to enter the preferred screenmode for playback. Double clicking on or
  25.    dragging a MPEG file to the iconbar icon, will start playback.
  26.  
  27. This version is not optimal though:
  28.  
  29. - Support for RISC OS 3.50 is minimal. It's not possible to enter mode
  30.   strings yet. As I own a 'humble' RISC OS 3.10 machine, I can't test this.
  31.   In the future it will be included, of course.
  32.  
  33. - I will soon replace the existing DCT routines in the decoder by faster
  34.   (ARM coded) routines.
  35.  
  36. - Better support for the Computer Concept's ColourCard and the new
  37.   improved video hardware of the Risc PCs. I have seen a version for a
  38.   Risc PC fitted with VRAM, which displayed the MPEG stream by directly
  39.   writing to VRAM. If people like this idea, it can be included.
  40.  
  41. Note: this port is partly based on the work done by Paul LeBeau. However,
  42. his port is dated somewhere in 1993, and I decided it was time for a new
  43. version. This was also caused by the fact, that Berkeley has just released
  44. the decoder as part of a number of tools:
  45.  
  46. mpegplay   - software-only MPEG-1 video decoder 
  47. mpegencode - software-only MPEG-1 video encoder 
  48. mpegstat   - a bitstream analysis tool 
  49. mpegblocks - an interactive tool to examine macroblock coding
  50. mpegbits   - an interactive to examine bit allocation to blocks
  51.  
  52. I'm planning to port all these programs to the Acorn Archimedes/RiscPC
  53. platform. I have also the source code of a MPEG sound player. As it's
  54. difficult to handle playback of these samples in real-time on a RISC OS
  55. machine, I would like to get in touch with people interesting in making
  56. this work.
  57.  
  58. This software is FREEWARE. Permission for non-profit distribution of this
  59. software is granted, provided it is distributed "as is", without change.
  60.  
  61. For bugs reports, suggestions or reactions:
  62.  
  63. Loek Frederiks
  64. Runmolen 88A
  65. 1823 GM Alkmaar
  66. The Netherlands
  67.  
  68. Phone  +31-72-111551 (home)
  69.        +31-8380-81448 (work)
  70.  
  71. E-mail: loek@xs4all.nl
  72.  
  73. Usage
  74. -----
  75.  
  76. mpegplay [ -nob ] [ -nop ] [ -loop ] [ -start num ] [ -end num ]
  77.          [ -gamma num ] [ -at xpos,ypos ] [ -leave ] [ file_name ]
  78.  
  79. Options
  80. -------
  81.  
  82. -nob
  83.  
  84. Causes the player to ignore and not display any B frames.
  85.  
  86. -nop
  87.  
  88. Causes the player to ignore and not display any P frames.
  89.  
  90. -loop
  91.  
  92. Makes the player loop back to the beginning after reaching the end.
  93.  
  94. -start num
  95.  
  96. Waits to start display until this frame number (previous frames are parsed).
  97.  
  98. -end num
  99.  
  100. Ends display at this frame number (continues parsing, for no good reason).
  101.  
  102. -gamma num
  103.  
  104. Gamma correction. Raise the luminance component of each pixel to num.
  105.  
  106. -at xpos,ypos
  107.  
  108. Postition the bottom-left corner of the displayed MPEG stream at these
  109. coordinates (in OS units).
  110.  
  111. -leave
  112.  
  113. Leave last frame on screen when movie finishes.
  114.  
  115. Notes
  116. -----
  117.  
  118. The player expects video streams only. It can handle multiplexed MPEG
  119. streams (video+audio streams) by discarding the audio.
  120.  
  121. Some streams do not end with the proper sequence end code and will probably
  122. generate an "Improper sequence end code." error when done playing.
  123.  
  124. This player can play XING data files. Be aware that XING makes no use of
  125. temporal redundancy or motion vector information. In other words, they do
  126. not use any P or B frames in their  streams. Instead, XING data is simply a
  127. sequence of I frames. Since I frames take significantly longer to decode,
  128. performance of the player using XING data is not representative of the
  129. player's ability.
  130.